home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / frontf.z / frontf
Encoding:
Text File  |  2002-10-03  |  3.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ffffrrrroooonnnnttttffff((((3333GGGG))))                                                          ffffrrrroooonnnnttttffff((((3333GGGG))))
  5.  
  6.  
  7.  
  8.  
  9. NNNNAAAAMMMMEEEE
  10.      ffffrrrroooonnnnttttffff - turns frontfacing polygon removal on and off
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ffffrrrroooonnnnttttffff((((bbbb))))
  14.      llllooooggggiiiiccccaaaallll bbbb
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _b   expects either .TRUE. or .FALSE..
  18.  
  19.           ....TTTTRRRRUUUUEEEE.... suppresses the display of frontfacing filled polygons.
  20.  
  21.           ....FFFFAAAALLLLSSSSEEEE.... allows the display of frontfacing filled polygons.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      ffffrrrroooonnnnttttffff allows or suppresses the display of frontfacing filled polygons.
  25.      If your programs represent solid objects as collections of polygons, you
  26.      can use this routine to expose hidden surfaces.    This routine works
  27.      best for simple convex objects that do not obscure other objects.
  28.  
  29.      A frontfacing polygon is defined as a polygon whose vertices are in
  30.      counter-clockwise order in screen coordinates.  When frontfacing polygon
  31.      removal is on, the system displays only polygons whose vertices are in
  32.      clockwise order.  For complicated objects, this routine alone may not
  33.      expose all hidden surfaces. To expose hidden surfaces for more
  34.      complicated objects or groups of objects, your routine needs to check the
  35.      relative distances of the object from the viewer (_z values).  (See
  36.      ``Hidden Surface Removal'' in the _G_r_a_p_h_i_c_s _L_i_b_r_a_r_y _P_r_o_g_r_a_m_m_i_n_g _G_u_i_d_e.)
  37.  
  38.      If ffffrrrroooonnnnttttffff and bbbbaaaacccckkkkffffaaaa are asserted simultaneously, no filled polygons will
  39.      be displayed.
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      backfa, zbuffe
  43.  
  44. NNNNOOOOTTTTEEEE
  45.      On IRIS-4D G and B models ffffrrrroooonnnnttttffff does not work well when a polygon
  46.      shrinks to the point where its vertices are coincident.  Under these
  47.      conditions, the routine cannot determine the orientation of the polygon
  48.      and so displays the polygon by default.
  49.  
  50.      On all IRIS-4D models matrices that negate coordinates, such as ssssccccaaaalllleeee ((((----
  51.      1111....0000,,,, 1111....0000,,,, 1111....0000)))),,,, reverse the directional order of a polygon's points and
  52.      can cause ffffrrrroooonnnnttttffff to do the opposite of what is intended.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.